home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1996 September / macformat-041.iso / mac / Shareware City / Graphics / MacSPD / README.Mac < prev    next >
Encoding:
Text File  |  1995-05-24  |  6.4 KB  |  168 lines  |  [TEXT/ttxt]
  1. SPD Update 3.6 - May, 1995
  2. =============================
  3.  
  4. Macintosh SPD
  5. Document by Eduard Schwan
  6.  
  7. Introduction
  8. ------------
  9.  
  10. SPD is a suite of raytracer scene generators, which can be used as benchmark
  11. databases for timing tests.  For a full description, see the file README.
  12.  
  13. This document will describe the Macintosh-specific information for these SPD
  14. archives.  There are also IBM PC versions of these archives available.
  15.  
  16. The SPD source code is being distributed as "Public Domain".  These Macintosh
  17. applications are also being distributed as public domain, no copyrights, no
  18. guarantees, no restrictions on their use or distribution.
  19.  
  20. The Macintosh port of SPD is contained in the archive MACSPD.SIT, and contains
  21. the SPD Mac Source code, for Symantec, Metrowerks or MPW C, and the SPD
  22. Mac Applications ready to run.
  23.  
  24. These Mac programs were written to be very simple.  There are no frills, and
  25. not much error checking.  They are meant to quickly crank out source files for
  26. raytracers.  Specifically, the "Display to Screen" code for the Macintosh is
  27. not very robust.  It works as a simple previewer on color Macintoshes, but it
  28. does not buffer offscreen, nor does it check for Color Quickdraw unless
  29. calling the screen display routines.  Be forewarned!  :-)
  30.  
  31.  
  32. Requirements
  33. ------------
  34.  
  35. The software requires a minimum Macintosh hardware and software configuration
  36. to run:
  37. - System 7.0 or higher, Runs fine on 7.1 & 7.5.1.
  38. - 68020 or higher CPU, does not require an FPU (Mac LC's and Quadras work
  39.   fine, as does the Power Macintosh in emulation mode.)
  40. - At least 1.5 MB Application RAM is recommended.
  41. - Color Quickdraw needed if imaging to the screen.
  42.  
  43.  
  44. Features
  45. --------
  46.  
  47. The Mac SPD is relatively MultiFinder friendly, letting you switch out on
  48. large file generations.  SPD will continue to work in the background.
  49. However, please see the Bugs section for some cosmetic annoyances with
  50. switching out.  It is a straight Macintosh application, with an initial
  51. dialog box to gather input (i.e. command line) information.
  52.  
  53.  
  54. How to Use
  55. ----------
  56.  
  57. To run any one of the SPD applications:
  58. (1) Double-click the application you want to run.
  59. (2) Select the output raytracer format from the popup menu.
  60. (3) Type in a number for the size,
  61.     -or-
  62.     Select an input file for the READxxx style applications.
  63. (4) Click the OK button, and the scene will be generated.
  64.     - If it is to the screen, the scene will be displayed immediately, in a
  65.       window.  When done, it will pause waiting for a mouse-click before quitting.
  66.     - If it is for a specific raytracer, it will create a textfile in the
  67.       same folder as the application, called APPNAME.out (e.g., the
  68.       application "rings" would create a file called "rings.out".)
  69. (5) Now run your favorite raytracer, and display and time the image.
  70.  
  71. NOTE:  POV-Ray Macintosh cannot open main scene files larger than 32k bytes,
  72. and many SPD files will be much bigger than this.  To get around this, create
  73. a small POV-Ray file whose sole purpose in life is to include the large .OUT file
  74. (e.g.  create a "rings.pov" that includes "rings.out".)  If you want to edit the .OUT
  75. file, you will need to use a "real" text editor or word processor that doesn't
  76. have the 32k limitation.
  77.  
  78.  
  79. Bugs
  80. ----
  81.  
  82. MacSPD does not set the file creator to anything.  The output file is of type
  83. text, but with no creator. Since it is an un-typed text file, you should not
  84. double-click it to open it.  Instead drag-n-drop it on your favorite word
  85. processor, or run the word processor and open it from the file menu.
  86.  
  87. If you switch out while drawing to the screen, and then switch back, the
  88. image display window is not refreshed.
  89.  
  90. Low memory conditions are not gracefully handled.  If you get an error, try
  91. increasing the application memory size from the Finder's "Get Info" window.
  92.  
  93. Color Quickdraw is not explicitly checked for on program startup.  If your run
  94. an SPD program on a non-Color QD Mac, it will run OK if you write to a file,
  95. but if you try to display to the screen, it will display an error dialog and
  96. quit.
  97.  
  98.  
  99. Notes
  100. -----
  101.  
  102. Larger size values may require that you increase the Application Memory Size.
  103. If you have limited memory and only want to create small sized files, you can
  104. get away with lowering the Application Memory Size, probably down to about 600K.
  105.  
  106. Currently, the only raytracers I know about for the Macintosh that the SPD
  107. programs support are:
  108.   POV-Ray
  109.   RTrace
  110.   RayShade
  111.   Renderman
  112. With the recent addition of DXF output, many more Mac ray tracers can import
  113. these files (Ray Dream, Infini-D, Strata, etc.)  The Macintosh versions of many
  114. of these raytracers can be found on the internet (ask Eric Haines at erich@eye.com
  115. for addresses), and the latest SPD and POV-Ray can also be found via anonymous ftp
  116. at povray.org, in the povray/Official/Macintosh/ area, and on CompuServe
  117. (GO GRAPHDEV), and on America Online (Keyword:PGR, Company Support.)
  118.  
  119.  
  120. Source Notes
  121. ------------
  122.  
  123. MPW:
  124. To compile under MPW 3.x, just type the following:
  125.   BuildProgram MacSPD
  126. That's it, every program will be created.
  127.  
  128. Symantec:
  129. To compile under Symantec C 7.x, just open each project file and
  130. "Build Application".  Symantec projects end in ".proj.sc".
  131.  
  132. Metrowerks:
  133. I've included project files for Metrowerks, and thye all compile and run
  134. under version 6.0.  HOWEVER, due to a bug in the way Metrowerks handles
  135. old K&R style functions mixed with ANSI prototypes, the TETRA application
  136. does not work.  All others seem to compile and run correctly, though I have
  137. not thoroughly tested them.  Just open each project and "Make" it.
  138. Metrowerks projects end in ".proj.cw".
  139.  
  140.  
  141. Credits & Information
  142. ---------------------
  143.  
  144. Eric Haines wrote the original SPD software.
  145.  
  146. Alexander Enzmann added the additional Raytracer support and did the original
  147. port to the IBM PC and the Macintosh (in Think C 5.)  He also created the
  148. SAMPLE and READDXF (was showdxf) data bases.
  149.  
  150. Eduard Schwan updated the Macintosh code to work with MPW C as well as
  151. Symantec C 6 & 7 & Metrowerks, added the initial dialog box to prompt for the "command
  152. line parameters", added the READNFF database, and created the PLATFORM_XXX
  153. stuff to make the code even more portable, and broke the lib.c file into several
  154. smaller pieces so as to be more grokkable by humans and toy Symantec
  155. compilers.
  156.  
  157. If you have any comments, questions or bug reports for the Macintosh version
  158. of these applications, please feel free to contact me.  General questions on
  159. SPD should be directed to the original author, Eric Haines.
  160.  
  161. Enjoy!
  162.  
  163. Eduard [esp] Schwan
  164.   CompuServe: 71513,2161
  165.   internet: 71513.2161@compuserve.com
  166.  
  167. [eof]
  168.